home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / chromat1.zip / CHROMATI.TXT < prev    next >
Text File  |  1994-04-30  |  22KB  |  595 lines
  1.  
  2.  
  3.  
  4.  
  5.             ____ _                               _   _ _
  6.            / ___| |__  _ __ ___  _ __ ___   __ _| |_(_) | _____
  7.           | |   | '_ \| '__/ _ \| '_ ` _ \ / _` | __| | |/ / __|
  8.           | |___| | | | | | (_) | | | | | | (_| | |_| |   <\__ \
  9.            \____|_| |_|_|  \___/|_| |_| |_|\__,_|\__|_|_|\_\___/
  10.  
  11.                The first International PC Multi-Group Music Disk
  12.                                     Volume I
  13.                                  April 28, 1994
  14.  
  15.                      Documentation by Trixter (Jim Leonard)
  16.  
  17.      Table of Contents:
  18.  
  19.      What is Chromatiks?.........................................2
  20.      Hardware Requirements.......................................2
  21.      Quick start.................................................3
  22.      Detailed Start..............................................3
  23.          command-line options....................................3
  24.      Controls....................................................4
  25.          displays................................................4
  26.          additional keys.........................................5
  27.      Troubleshooting.............................................6
  28.          locks up your machine...................................6
  29.              PAS 16..............................................6
  30.          No sound, or garbled sound..............................6
  31.          songs do not load or play correctly.....................6
  32.          Screen doesn't move.....................................6
  33.          Notes don't display correctly...........................6
  34.          Music sounds wrong......................................6
  35.              16-bit sound card...................................6
  36.          stereo panning method...................................6
  37.          GUS sound is wrong......................................6
  38.          GUS doesn't output sound................................6
  39.              ULTRINIT............................................6
  40.      History.....................................................7
  41.      The Future..................................................7
  42.          submissions.............................................7
  43.      Acknowledgements............................................7
  44.      Music formats that Chromatiks can play......................8
  45.          MOD.....................................................8
  46.          STM.....................................................8
  47.          669.....................................................8
  48.          S3M.....................................................8
  49.          MTM.....................................................8
  50.      Explanation of Terms........................................9
  51.          Chromatiks..............................................9
  52.          Music Disk..............................................9
  53.          Demo....................................................9
  54.          Intro...................................................9
  55.          Group...................................................9
  56.          Scene...................................................9
  57.          Mixing..................................................9
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.                                                                      Page 2
  72.                               What is Chromatiks?
  73.                               ~~~~~~~~~~~~~~~~~~~
  74.  
  75.      Chromatiks is  the first  International PC Multi-Group Music Disk.  If
  76.      you aren't  familiar with the concept of a music disk, then I strongly
  77.      suggest you  skip to the end of this document and read the section en-
  78.      titled "Explanation  of Terms".  If you are familiar with music disks,
  79.      however, then here's a quick list of "should's" and "shouldn'ts":
  80.  
  81.      Why you SHOULD listen to Chromatiks:
  82.  
  83.      -    Variety.   Music has  been contributed  from all  over the world,
  84.           from different groups.  There's something for everyone!
  85.      -    Quality.   This volume  features music from some of the most well
  86.           known composers  in the  scene, like Purple Motion / Future Crew,
  87.           Cybelius / Sonic, and others.
  88.      -    Clarity.  The Chromatiks Player has been optimized for loud, true
  89.           playback on  8-bit cards,  and also  optimized for crystal clear,
  90.           exact playback on 16-bit cards, like the Sound Blaster 16 and the
  91.           Pro Audio  Spectrum.  With the exception of DMP, PMP, or IPLAY, I
  92.           doubt you'll  find a  better player.  (You can even use the Chro-
  93.           matiks player to play your own MOD, 669, STM, S3M, or MTM files!)
  94.      -    Originality.   There have  been many music disks before this one,
  95.           but they have featured music from the same group.  Chromatiks has
  96.           music from different groups, from all over the world!
  97.      -    Versatility.   You can  use the Chromatiks player program to play
  98.           your own songs!
  99.  
  100.      Why you should NOT listen to Chromatiks:
  101.  
  102.      -    Since I added GUS support, there isn't one.  :-)
  103.  
  104.                              Hardware Requirements
  105.                              ~~~~~~~~~~~~~~~~~~~~~
  106.  
  107.      -    386 or higher
  108.      -    100% compatible VGA card and monitor (Chromatiks uses tweaked
  109.           modes, split screen modes, and fast palette fades)
  110.      -    570K of RAM (or less, depending on the sound card and quality
  111.           mode used)
  112.      -    2 Meg of EMS memory
  113.      -    Microsoft Mouse
  114.      -    And if you own a GUS, 512K GUS RAM
  115.  
  116.      And, of course, one of the following sound cards:
  117.           -    Sound Blaster, Sound Blaster Pro, Sound Blaster 16
  118.           -    Pro Audio Spectrum, Pro Audio Spectrum Plus, Pro Audio
  119.                Spectrum 16
  120.           -    Windows Sound system
  121.           -    Sierra Aria chipset-based card
  122.           -    Gravis Ultrasound
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.                                                                      Page 3
  138.                                   Quick start
  139.                                   ~~~~~~~~~~~
  140.  
  141.      1)   Load Chromatiks onto your hard drive and type "Chromati" and hit
  142.           <ENTER>.
  143.      2)   Use the left mouse button to select things and the right mouse
  144.           button to exit the section you're in.
  145.      3)   Listen to the great music.  Look at the cool displays.  :-)
  146.  
  147.                                  Detailed Start
  148.                                  ~~~~~~~~~~~~~~
  149.  
  150.      Before you  begin, make  sure that you meet the hardware requirements.
  151.      If you  need to use a memory manager to get 580K DOS memory free, then
  152.      please do!  Chromatiks has been tested successfully with QEMM, 386MAX,
  153.      and EMM386.  (Besides, you'll probably *have* to load a memory manager
  154.      to provide  Chromatiks with the 2 MEG EMS memory it needs.)  Load your
  155.      mouse driver  if necessary.  To simply run Chromatiks, type "chromati"
  156.      and hit <ENTER>.
  157.  
  158.      That's all  there is;  Chromatiks should immediately go into its title
  159.      sequence.   Before you  simply run Chromatiks, though, you should know
  160.      about its command-line options:
  161.  
  162.           -query overrides  the sound  card autodetection.   (If  you  hear
  163.                     nothing out  of your  sound card,  or what  you hear is
  164.                     garbage, your card may not be autodetected correctly by
  165.                     Chromatiks' internal  routines.   Selecting this option
  166.                     will tell Chromatiks exactly what you have.)
  167.  
  168.      There are also speed selections that control the mixing speed and
  169.      quality:
  170.  
  171.           -slow is  for slow  computers, like  a  386  at  16  or  20  MHz.
  172.                     (Hopefully, Chromatiks  is fast enough to avoid the ne-
  173.                     cessity of this switch.)
  174.           -medium is  for medium  speed computers,  like a  25 MHz machine.
  175.                     (Use this  switch if  you feel your computer can handle
  176.                     this quality level.)
  177.           -fast is  for fast computers, like 33MHz or higher.  (Use this if
  178.                     you want to see if your computer can handle the maximum
  179.                     quality level  of your  sound card.  A 33MHz machine or
  180.                     higher is highly recommended to use this switch.)
  181.  
  182.      Finally, there are miscellaneous switches, like:
  183.  
  184.           -title, which  skips the  title screen if you've seen it too many
  185.                     times.
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.                                                                      Page 4
  204.      You can also pass the name of a MOD, 669, STM, S3M, or MTM file as the
  205.      first argument.   This  way, you  can use  Chromatiks to play your fa-
  206.      vorite songs.
  207.  
  208.      Example:   If you wanted to play your favorite MOD through your snazzy
  209.      16-bit sound  card, but you only have a 386-16MHz and Chromatiks isn't
  210.      finding your card correctly, then you would type:
  211.  
  212.           chromati gslinger.mod -slow -query
  213.  
  214.      After starting Chromatiks, you should see title sequence, and then you
  215.      will be  provided with a stereo selection screen (this depends on your
  216.      sound card,  and whether  or not  your card  supports stereo  output).
  217.      Choose the stereo panning method you want with the mouse.  As you move
  218.      the mouse  onto one of the selections, you'll hear the music change to
  219.      reflect what the panning sounds like.
  220.  
  221.                                     Controls
  222.                                     ~~~~~~~~
  223.  
  224.      After you  select your  stereo panning method, you'll go to the player
  225.      screen.  The player screen has two sections; the informational text on
  226.      the bottom,  and the  displays on  the top.  The text on the bottom is
  227.      written by  the composers themselves, and what text you see depends on
  228.      what music  you're listening  to at  the time.   At  the top  are  the
  229.      displays:
  230.  
  231.      -    The bar display shows the exact volume level of each channel.
  232.      -    The oscilloscope  display shows  what the  sound  waveform  looks
  233.           like.  (Disabled in GUS mode)
  234.      -    The note/staff  display shows  what notes the individual channels
  235.           are playing.
  236.      -    The titles  display shows what song is playing and which song you
  237.           have currently selected.
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.                                                                      Page 5
  270.      If you  do nothing,  Chromatiks will  start at the first song and play
  271.      all six  songs, and then loop around and play the first one again.  To
  272.      end Chromatiks, press the right mouse button, or the <ESC> key.
  273.  
  274.      While the  music is playing, you have several options.  To view a dif-
  275.      ferent display,  you can  move the  mouse left  and right, and the top
  276.      section will scroll to follow the mouse.  Once you get over to the ti-
  277.      tles screen,  moving the  mouse up  and down  will move  the selection
  278.      highlight; pressing  the left  mouse button will stop the current song
  279.      and play the one you've selected.
  280.  
  281.      Here are some additional keys:
  282.  
  283.      +         Skip the song forward one pattern.
  284.      -         Skip the song backward one pattern.
  285.      L         Make the volume louder.
  286.      S         Make the volume softer.
  287.      P         Toggle playback.  Hit it once to pause the output, hit again
  288.                to resume
  289.      J         Toggle "jumptracks."   When  this is  on, the  display  will
  290.                "jump" in  time to one of the tracks.  Press J again to turn
  291.                "jumptracks" off; press any number key to select which track
  292.                to jump to.  This option is not very useful.  :-)
  293.      <ESC>     Exits the player program and goes to the credits screen.
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.                                                                      Page 6
  336.                                 Troubleshooting
  337.                                 ~~~~~~~~~~~~~~~
  338.  
  339.      If you are having problems with Chromatiks, check this list:
  340.  
  341.           Chromatiks locks  up your  machine or hangs:  Make sure your
  342.           current system  setup meets  Chromatik's hardware and memory
  343.           requirements.   Note:  Some PAS 16 owners with 386-40's have
  344.           noticed that  they cannot get Chromatiks to work unless they
  345.           use the  -medium option;  if you  fall into  this group, use
  346.           that command-line option.
  347.  
  348.           No sound,  or garbled  sound:   Chromatiks might not be cor-
  349.           rectly autodetecting your sound card.  Use the -query option
  350.           to manually  specify your  card and  it's settings.  If your
  351.           card is  not explicitly  listed, see  if it emulates another
  352.           popular sound  card.  Note:  If you are unsure of your sound
  353.           card's makeup,  use -query  and specify a Sound Blaster with
  354.           IRQ 5  (or 7,  if your sound card is over 2 years old), PORT
  355.           220, and DMA 1.
  356.  
  357.           Some songs  do not  load or  play correctly:   Make sure you
  358.           have 570K  free DOS  memory and  2 Megabytes  of EMS memory.
  359.           Note:   When Chromatiks  loads it's songs, it displays a pe-
  360.           riod for  every song.   If  any periods  are flashing,  they
  361.           didn't load  correctly.  This can be due to a corrupted file
  362.           or not enough memory.
  363.  
  364.           Screen doesn't  move around:   Make sure your Microsoft-com-
  365.           patible mouse driver is loaded before you run Chromatiks.
  366.  
  367.           Notes don't display correctly:  Notes that fall above or be-
  368.           low the  octaves displayed  on the screen are not displayed.
  369.           A larger display will be in a future release.
  370.  
  371.           Music sounds wrong, staggered, or slow:  Make sure your com-
  372.           puter is  fast enough  to support  the quality of your sound
  373.           card.   Use the  -medium or -slow options if you have to.  A
  374.           386-40 or higher is recommended to hear sound at its highest
  375.           quality setting  on a  16-bit sound  card.   Also, using the
  376.           "speaker" stereo  panning method takes up less CPU time than
  377.           "headphones", so  use the  "speakers" method  if you  have a
  378.           slower machine.
  379.  
  380.           GUS sound  is wrong:  This version of Chromatiks had its GUS
  381.           support added  late in  its development.   It  uses a vastly
  382.           different playing  engine than the mixing routines, and some
  383.           notes may  be dropped.   Also, you need 512K GUS RAM to hear
  384.           most of the songs correctly.
  385.  
  386.           GUS doesn't output sound at all:  Sometimes the GUS does not
  387.           get  initialized  correctly  by  Chromatiks.    Try  running
  388.           ULTRINIT with no parameters before running Chromatiks.
  389.  
  390.      If you  still have  problems, please  contact Jim Leonard using one of
  391.      the methods  described in the submit!.txt file provided with the Chro-
  392.      matiks distribution  package.  I will do everything I can to get Chro-
  393.      matiks working on your computer.
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.                                                                      Page 7
  402.                                     History
  403.                                     ~~~~~~~
  404.  
  405.      Chromatiks started in October of 1993 as my personal project: I'd seen
  406.      many music  disks, but  none that had music from all different groups.
  407.      I posted  a message  to the  Usenet group comp.sys.ibm.pc.demos asking
  408.      for interest,  and Kalle Kaivola (Edge / Unexpected) replied.  He con-
  409.      tacted all  of his  friends in  different groups and got the first six
  410.      songs rounded  up.   With his  help (and beta testing), Chromatiks was
  411.      released on April 28, 1994.
  412.  
  413.      My sincere gratitude goes to Kalle and all of the people who were kind
  414.      enough to  donate tunes  to a project they knew nothing about:  Kalle,
  415.      Prism, Purple  Motion, Tonedeaf,  Cybelius, and  Jayjay; that  kind of
  416.      generosity is hard to come by.
  417.  
  418.                                    The Future
  419.                                    ~~~~~~~~~~
  420.  
  421.      Chromatiks is not "a flash in the pan"; rather, we plan for Chromatiks
  422.      to come  out every  two months,  with all  new tunes and continued ad-
  423.      vancements to  the player  program.  Chromatiks depends on submissions
  424.      from musicians  to continue,  however.   If you're part of a group but
  425.      don't have  a project  planned, please contact us!  What better way to
  426.      have your  great music  spread around?  If you're not part of a group,
  427.      that's okay  too:   Chromatiks is not necessarily limited to people in
  428.      groups.   To contact  us, see  the file  submit!.txt included with the
  429.      Chromatiks package.
  430.  
  431.                                 Acknowledgements
  432.                                 ~~~~~~~~~~~~~~~~
  433.  
  434.      Trixter would like to thank the following people:
  435.  
  436.           Jussi and  Otto of Virtual Visions, for their suggestions and in-
  437.           sight.  Those guys are real professionals.
  438.  
  439.           Brian Hirt,  for always  looking at my code (even though he knows
  440.           he's a  *much* better programmer than I am), offering insight and
  441.           a simple fix to a complicated problem.
  442.  
  443.           The XLIB  people, for  providing the best information yet on pro-
  444.           gramming Mode X.
  445.  
  446.           Tristan Tarrant,  for translating  the XLIB  library to something
  447.           more manageable.
  448.  
  449.           NDanger /  Unexpected, for redrawing my idea into a masterwork of
  450.           a title  screen, and  for providing  the credits font.  (My mouth
  451.           hung open the first time I saw the new title screen!)
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.                                                                      Page 8
  468.                      Music formats that Chromatiks can play
  469.                      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  470.  
  471.      MOD:           Amiga Protracker.   The  most popular music file format
  472.                     in the  demo scene.  Originating on the Amiga computer,
  473.                     MODs contain  up to  4 channels of music.  Later PC im-
  474.                     plementations of the MOD format introduced 6 or 8 chan-
  475.                     nels.
  476.  
  477.      STM:           Scream Tracker.  This music format was created by Psi /
  478.                     Future Crew.   Very  similar to the MOD format, it also
  479.                     contains up to 4 channels.
  480.  
  481.      669:           This music  format was created by Tran, formerly of Re-
  482.                     naissance.   It was  the first 5+ channel format on the
  483.                     PC; contains up to 8 channels.
  484.  
  485.      S3M:           Scream Tracker  3.0.   A later  modification of the STM
  486.                     format.   Supports up  to 16 channels; the tracker used
  487.                     to create  these modules  is possibly  the best  on the
  488.                     scene.
  489.  
  490.      MTM:           MultiTracker.  A new format created by StarScream / Re-
  491.                     naissance.  Supports up to 32 (!) channels.
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.                                                                      Page 9
  534.                               Explanation of Terms
  535.                               ~~~~~~~~~~~~~~~~~~~~
  536.  
  537.      Chromatiks:    The first  truly multi-group  music disk  for  the  PC.
  538.                     Chromatiks was  coded by  Jim Leonard in Borland Pascal
  539.                     7.0 and  it's built-in  assembler.  Additional routines
  540.                     were provided by Otto Chrons and Jussi Lahdenniemi.
  541.  
  542.      Music Disk:    A program  that  plays  music  from  musicians  of  the
  543.                     demo/intro scene.   PC music disks use mixing and other
  544.                     demo techniques to play MODs and other file formats.
  545.  
  546.      Demo:          A program  that shows off the power of the computer and
  547.                     the skill of its programmer using light, color, shapes,
  548.                     sound, music,  and ingenuity.  Many demos have detailed
  549.                     artwork, 3D  objects swirling  around the  screen,  and
  550.                     rousing music, for example.
  551.  
  552.      Intro:         A demo  that is  smaller than  100K.   Usually does one
  553.                     thing only, like introduce a new group, event, or BBS.
  554.  
  555.      Group:         A group of individuals who write a demo or intro.  Usu-
  556.                     ally consists  of at  least one  of  the  following:  a
  557.                     coder, a graphics artist, and a musician.
  558.  
  559.      Scene:         Slang; a  collection of  groups that share a common in-
  560.                     terest.
  561.  
  562.      Mixing:        A technique  to overcome  the limitations  of PC  sound
  563.                     hardware.   Normally, PC  sound cards can output one or
  564.                     two channels  of digitized sound, which isn't very use-
  565.                     ful if  you want to play music with 8 or more channels.
  566.                     Mixing overcomes this limitation by utilizing the power
  567.                     of the  computer to mathematically mix all of the chan-
  568.                     nels into  only one  or two channels inside of the com-
  569.                     puter.   The resulting channel or channels is then out-
  570.                     put through the sound card.  (The number of channels in
  571.                     the output depends on whether the sound card is mono or
  572.                     stereo.)   The quality  of the output is usually excel-
  573.                     lent, but  can depend  on the  number of channels being
  574.                     mixed and the speed of the computer.
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.